home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d909.lha / GoldED2 / Tools / HiSpeed / ManualE < prev    next >
Text File  |  1993-08-28  |  17KB  |  382 lines
  1.  
  2.             Installation, Hardware/software requirements
  3.             --------------------------------------------
  4.  
  5.   o Amiga, OS2.04 or better, PCL printer (DeskJet, Laser, ...)
  6.   o the 'reqtools.library' by Nico François (©1991-1993)
  7.   o xpk.library (by U. Dominik Müller, Bryan Ford, ...)
  8.  
  9.   HiSpeed  is  a printing utility for DeskJet/laser printers. It is
  10.   quite  similar  to  Matt  Melcher's HDPrint programs ("4 pages of
  11.   text  to one A4 side"): Output is reduced to a few pages by using
  12.   small typefaces. It is fast. Speed depends on your DeskJet model;
  13.   DeskJet+:  about 4 pages/minute if you switch to HiSpeed mode. It
  14.   should  be  a  nice  utility  for  people who have to do a lot of
  15.   printing.
  16.  
  17.                             REQUIREMENTS
  18.                             ------------
  19.  
  20.   Amiga,  at  least  512K,  OS2.04,  DeskJet/Laser.  You'll  need a
  21.   softfont cartridge (a RAM expansion card) for your DeskJet if you
  22.   want  to  use  all  functions of this program - otherwise you are
  23.   limited to the printer's ROM fonts.
  24.  
  25.  
  26.                               FEATURES
  27.                               --------
  28.  
  29.   o easy-to-use workbench interface (but shell interface & ARexx
  30.     port are available as well)
  31.  
  32.   o single or double sided printing; stack of paper has to be 
  33.     turned only once (if at all).
  34.  
  35.   o free layout - e.g. 4*4 blocks of text (= 4 A4-pages) or two
  36.     columns, or ... Portrait/landscape printing are available.
  37.  
  38.   o A5 book mode; covers are printed, too
  39.  
  40.   o blocks are seperated by lines (optional)
  41.  
  42.   o important ESC-sequences are supported: Italics, LQ/EDV, Tabs,
  43.     Underlines, FF, ... (ANSI sequences, i.e. device independend)
  44.  
  45.   o Linefeed can be set to one of eight values
  46.  
  47.   o you can print more than one file ("job") simultanously - just 
  48.     set up the job list
  49.  
  50.   o HiSpeed mode: ESC sequences are recognized and removed. Output 
  51.     is performed as fast as possible.
  52.  
  53.   o Prescan/Preview are available (WYSIWYG)
  54.  
  55.   o several fonts available for output (number depends on your 
  56.     printer); softfonts are supported
  57.  
  58.   o Sleep mode: HiSpeed's window is replaced by a small AppIcon on
  59.     the workbench screen. Drag icons over it to have them printed.
  60.  
  61.   o optional page headers are possible as well as numbering of 
  62.     lines
  63.  
  64.   o automatic index generation
  65.  
  66.   o appendix generation of marked words
  67.  
  68.  
  69.                             CONFIGURATION
  70.                             -------------
  71.  
  72.   HiSpeed  has  to  be  configured according to your printer - just
  73.   choose  your  model  from the list of supported printers. Set the
  74.   RAM  gadget  to  'RAM'  if  your  printer  is equipped with a RAM
  75.   expansion  cartridge  (DeskJet) or doesn't require additional RAM
  76.   in  order  to  use  softfonts.  The number of available typefaces
  77.   depends  on  Printer/RAM  selection  -  while  a standard DeskJet
  78.   without  RAM  is limited to one typeface, a DeskJet 550C with RAM
  79.   will offer 4 portrait fonts and 3 landscape fonts. If you printer
  80.   is  not  supported  by  HiSpeed so far, you'll have use the SetUp
  81.   option  to register your printer with HiSpeed (see SetUp manual).
  82.   Finally  you  should  select  a  screen font (project menu/select
  83.   font)  to  be  used by HiSpeed since the program doesn't adopt to
  84.   the screen font automatically; default is topaz 8.
  85.  
  86.  
  87.                               PRINTING
  88.                               --------
  89.  
  90.   The  files  ("jobs")  to  be  printed are displayed as "job list"
  91.   (bottom  left). Scroll through that list using the arrow gadgets.
  92.   Use  'Add' to add new jobs. A file requester will appear. You may
  93.   add  more  than  one  file  at once by holding down the shift key
  94.   during selection. There are other methods to add files to the job
  95.   list,  too:  Just  drag a file's icon over the HiSpeed window. Or
  96.   set  up  a  file via Arexx. Or let a file drop on HiSpeed's sleep
  97.   icon  (however,  if you do so, it will be printed at once but not
  98.   included into the job list).
  99.   
  100.   Use job <menu/clear list> to clear the complete list respectively
  101.   the  'del' gadget to remove a single file. Select "SORT A" if you
  102.   want to have the list sorted alphabetically. Use "sort #" to sort
  103.   by size.
  104.  
  105.   Start  printing  by  clicking  at  the  print  gadget.  Jobs  are
  106.   processed from top to bottom. If none has been set up so far, you
  107.   will  be  asked  for a file. You may stop printing by closing the
  108.   progress window  (HiSpeed  will  ask  for confirmation). Download
  109.   mustn't be interrupted for this would confuse the printer.
  110.  
  111.   It  is  possible  to  print  single sheets, too, using the 'page'
  112.   gadget.  This option is useful to reprint some lost passages of a
  113.   large job (e.g. if ink cartridge went empty during printing).
  114.  
  115.   If  you  want  a  page  header (file name, page number), activate
  116.   "PAGE  HEADER". See 'SetUp' on how to set up the header text (for
  117.   example  it  is possible to have time/date strings or environment
  118.   variables  inserted).  If you print more than one file, you might
  119.   want an index: switch to header & index.
  120.  
  121.  
  122.                           SETTINGS & UNITS
  123.                           ----------------
  124.  
  125.   Usually  you  won't  have  to  change  paper  dimensions. Default
  126.   settings  are  valid  for output to A4. The left border should be
  127.   sufficient  for perforating. Hit "RESET ALL" go get the defaults.
  128.   All  settings  are  written  to  HiSpeed's  configuration file by
  129.   <project  menu/save  config>. Be careful as far as the dimensions
  130.   setup  is  concerned  -  wrong  values  (especially  insufficient
  131.   borders) will confuse HiSpeed.
  132.  
  133.   HiSpeed  v5.0  or  better  does  write  its configuration file to
  134.   "ENVARC:HISPEED"  unless  a  different  directory  is  specified.
  135.   Former  releases  used to write to 's:' or directly to 'envarc:'.
  136.   Those files should be removed.
  137.  
  138.   Units  are  'mm'  with exeption of the block size display - which
  139.   uses  [characters]  to  display  text block dimensions. The block
  140.   size  depends  on border/paper settings as well as font selection
  141.   (font width).
  142.  
  143.                                 LAYOUT 
  144.                                 ------
  145.  
  146.   Layout  definition  (the  number/arrangement  of text blocks on a
  147.   page)  is  of  great  importance  for a pleasing result: The more
  148.   block  columns  you  order,  the  less characters will fit into a
  149.   block  line.  If  the  block  with is too small, lines have to be
  150.   splitted.
  151.  
  152.   Block  width  depends  on  the  selected font, too. If you select
  153.   Courier  6  (this  is  the  only  font  offered  by  the standard
  154.   DeskJet),  no more than 75 characters will fit into a single line
  155.   provided  you  use  a  layout  of  two  columns.  In generally 75
  156.   characters  is  not enough. You might use the Adjust-LF option in
  157.   this  case:  It  will remove LF (line feed) codes. However, don't
  158.   use this option with formatted data (tables or source codes).
  159.  
  160.   Edit  contents  of  the dx/dy gadgets to set the distance between
  161.   columns/rows.  Enable the 'separate' option if you want to have a
  162.   line drawn between two block rows. Blocks are linked from left to
  163.   right and from top to bottom.
  164.  
  165.                                PREVIEW
  166.                                -------
  167.  
  168.   HiSpeed  offers two ways of quality/volume precalculation without
  169.   having  to waste a single page of paper: Use 'preview' to order a
  170.   WYSIWYG  preview.  Or  use  'scan'  to get some statistics ( e.g.
  171.   required  number  of  sheets).  While  scanning  is faster than a
  172.   preview, the latter is more useful to get a general impression of
  173.   the  output. Use the cursor keys to flip through pages in preview
  174.   mode. Use the help key to open the statistics requester.
  175.  
  176.   The  distortions  value  of  the statistics display is related to
  177.   text  lines  that  were  to long to fint into a single block line
  178.   (i.e. lines that had to be splitted). Possible values are from 0%
  179.   to  100%.  This value should be as low as possible since splitted
  180.   lines  don't  look that well. Decide for a smaller font, use less
  181.   columns or decrease margins to avoid distortions.
  182.  
  183.  
  184.                                 FILES
  185.                                 -----
  186.  
  187.   HiSpeed  has been designed to process ASCII files with or without
  188.   ANSI  codes.  Lines have to be terminated by LF codes. Additional
  189.   CR  codes  (used  by  MS-DOS software) are recogized and removed.
  190.   Turn  the  MS-DOS  option  ON  if  you want to print MS-DOS files
  191.   (maybe recieved from a BBS system) - HiSpeed will use a different
  192.   character  set  to  cope  with  these  files.  Softfonts  are not
  193.   available  in  MS-DOS  mode because they have been developed with
  194.   the Amiga chacaracter set (ecma latin) in mind.
  195.  
  196.  
  197.                             ESC-SEQUENCES
  198.                             -------------
  199.  
  200.   Switch  to  HiSpeed  mode  or turn PERFORM ESC off if you want to
  201.   have  ESC-Sequences  ignored  (and  thus speed up output). If you
  202.   enable  FFs (form feeds), every detected FF-code (12 dez) results
  203.   in  a new text block. You better have a prescan to estimate paper
  204.   needs  - some files (especially library manuals using the AutoDoc
  205.   format) send FF codes after each paragraphe.
  206.  
  207.   HiSpeed mode does imply draft printing/normal stroke. Other modes
  208.   use  LQ  printing,  EDV printing or bold printing. These settings
  209.   stay  valid  until  they  are  turned  off by approbiate ANSI ESC
  210.   sequences  being  part  of  the  file(s)  to  print.  The are not
  211.   affected by ESC sequences if 'perform ESC' is off.
  212.  
  213.  
  214.                             CHARACTER HEIGHT
  215.                             ----------------
  216.  
  217.   Several  fonts  are  available  (number  depends  on your printer
  218.   model),   e.g.   LinePrinter-5,   LinePrinter-6,   Courier-6  and
  219.   LetterGothic-5. You should use LinePrinter-5 or LGothic-6, if the
  220.   average  line  width  of  your  text  files  is  greater  than 80
  221.   characters.  LinePrinter-6  looks  better  but  block width might
  222.   become  too  small  (e.g. 80 characters if you choose a layout of
  223.   two  columns).  Courier-6 is the worst choice: no more than about
  224.   75  characters will fit into a line if you decide for a layout of
  225.   two columns.
  226.  
  227.                           PORTRAIT / LANDSCAPE
  228.                           --------------------
  229.  
  230.   All  DeskJet  models  apart  from the original DeskJet do support
  231.   landscape  printing.  The  number of fonts available in landscape
  232.   mode depends on your printer model.
  233.  
  234.  
  235.                                   BOOK
  236.                                   ----
  237.  
  238.   If  you  enable  book  mode  output is sorted in a way to support
  239.   manual  creation:  simply  fold printed sheets to get A5 manuals.
  240.   HiSpeed relies on the user's settings: if you set the block width
  241.   to  120  columns but the actual (average) line width of a text is
  242.   60  chacaters, output won't look good (columns are not centered).
  243.   Simply  run  the AdjustBook macro after switching to book mode to
  244.   have  the  layout adjusted automatically. Since book mode usually
  245.   implies   landscape  printing  (not  supported  by  the  original
  246.   DeskJet),  this  mode  should  only  be  used  with a DeskJet+ or
  247.   better.
  248.  
  249.                                 COVER
  250.                                 -----
  251.  
  252.   Select  'cover' to order printing of A5 covers. Several templates
  253.   are  available.  Quality  of cover printing depends on the LQ/NLQ
  254.   gadget.  This  function  requires  the  XPK  library.  Coverfiles
  255.   actually  are  PCL files (i.e. files ususally sent to a printer).
  256.   They  have  been  chrunched  using  xDrop  of  the  XPK  package.
  257.   Recommended  file  extension  for  color  files is *.CYM (DeskJet
  258.   500C)  or  *.CYMK  (DeskJet  550C).  Have a look at the templates
  259.   directory if you are looking for the PageStream documents used to
  260.   create the original HS cover files.
  261.  
  262.  
  263.                           SINGLE/DOUBLESIDED
  264.                           -------------------
  265.  
  266.   Single sided as well as double sided printing is available. Don't
  267.   get  confused  if  HiSpeed appears to eject empty pages in double
  268.   sided  mode  -  those  pages  are  required by the second pass of
  269.   printing.
  270.  
  271.   *****************************************************************
  272.   Take care of HiSpeed's advice if the program asks you to reinsert
  273.   ejected  pages  in order to print the backsides. Handling depends
  274.   on printing mode !
  275.   *****************************************************************
  276.  
  277.  
  278.                               PERFORATE
  279.                               ---------
  280.  
  281.   Enable  'perforate'  if  you  want  to have perforation considerd
  282.   during  double-sided output, i.e. to make HiSpeed swap left/right
  283.   borders if necessary to ensure a sufficient left margin.
  284.  
  285.  
  286.                              OUTPUT DEVICE
  287.                              -------------
  288.  
  289.   Use  the port gadget to select desired output device respectively
  290.   output  file.  If  output goes to a file, HiSpeed will create two
  291.   files  (even/odd  pages)  using  file extension 1 respectively 2.
  292.   File  1  has  to  be  sent to your printer before file 2 later on
  293.   since (only) this file will keep softfont data.
  294.  
  295.  
  296.                             SHELL INTERFACE
  297.                             ---------------
  298.  
  299.   HiSpeed  can be usewd from a shell. Or by any program providing a
  300.   shell   startup   like  Stefan  Becker's  ToolManager.  Supported
  301.   arguments  are  (according  to  the  template  scheme used by the
  302.   AmigaDos manual):
  303.  
  304.      FILE/M,   S=SLEEP/S,   D=DOUBLE/K,  H=HEADER/K,  N=NUMBER/K,
  305.      H=HISPEED/K, P=PREVIEW/S, C=SCAN/S, L=LANDSCAPE/K, B=BOOK/K,
  306.      F=FEED/N,   I=INDEX/S,   LQ/S,  EDV/S,  BOLD/S,  ADJUSTLF/K,
  307.      SORTNAME/S,   SORTSIZE/S,   ASL/S,   SCREEN/K,  PERFORATE/K,
  308.      CMDFILE/K,  MSDOS/K,  UNI/K,  ANSI/K,  PARSEFF/K,  FILTER/K,
  309.      PAR:/S, SER:/S, RESET/S:
  310.  
  311.   Characters  after  a  slash  describe  the option's type (e.g. /S
  312.   would  mean  'switch').  Characters followed by '=' are shortcuts
  313.   (e.g.  H is a shortcut of HEADER). The following option types are
  314.   available:
  315.  
  316.     K .... Keyword asssignment. Example: HISPEED DOUBLE=TRUE. The '=' 
  317.            may be omitted. Valid argumets are ON or OFF.
  318.  
  319.     S .... Switch. These Options set a special mode/perform some
  320.            action *IF* they are specified. No argument (like ON) 
  321.            expected. Example: HISPEED RESET
  322.  
  323.     N .... These options introduce numerical values; example:
  324.            HISPEED FEED=3. The '=' may be omitted.
  325.  
  326.     M .... Introduces list of files. The option name itself (FILE)
  327.            may be omitted. Example usage: 
  328.  
  329.            'HiSpeed FILE s:user-startup s:startup-sequence'.
  330.          
  331.  
  332.   Since all options mentioned above do perform more or less the same
  333.   action as the gadgets of HiSpeed's GUI, I'm not going to describe
  334.   them once more.
  335.  
  336.                              AREXX PORT
  337.                              ----------
  338.  
  339.   HiSpeed's  ARexx interface is described in the file ARexxEDoc. By
  340.   using  ARexx  it  is  possible  to  add  headers  to files before
  341.   printing them, to format a text, to generate an appendix, to move
  342.   HiSpeed to a different (public) screen, ....
  343.  
  344.  
  345.                                MACROS
  346.                                ------
  347.  
  348.   ARexx  macros  found  within  the  HISPEED/AREXX directory during
  349.   startup  are  gathered as MACRO menu. Please read the 'ARexxEDoc'
  350.   manual for more details about ARexx.
  351.  
  352.  
  353.                                 FILTER
  354.                                 ------
  355.  
  356.   Toggle  'FILTER'  ON if you want the '@' character to be regarded
  357.   as  keyword  qualifier.  It will be removed before output. Have a
  358.   look at the MakeAppendix macro.
  359.  
  360.  
  361.                               SLEEP-ICON
  362.                               ----------
  363.  
  364.   Use  the 'Zzz' gadget to iconify HiSpeed. You may drag files over
  365.   the  icon to have them printed - it's an AppIcon. Doubleclick the
  366.   icon  to  wake  HiSpeed  up  again.  Since  the Amiga OS does not
  367.   support  reading  AppIcon  coordinates,  HiSpeed won't be able to
  368.   remember  the  icon  position  after you have moved it to another
  369.   location.  Nevertheless  it is possible to snapshot the preferred
  370.   position:  Open  the  'prefs/env-archive/hispeed' directory. Move
  371.   the   'AppIcon'  icon  from  within  that  directory  to  desired
  372.   location, than snapshot it (icon menu of workbench). Finally move
  373.   the  icon  back to its drawer. HiSpeed will read the new position
  374.   the next time it is evoked.
  375.  
  376.                                 SETUP
  377.                                 -----
  378.  
  379.   It is possible to adjust HiSpeed to almost any PCL printer (many
  380.   ink printers, many laser printers). Have a look at the 'Setup'
  381.   text for details.
  382.